home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / useron21.zip / USERON.DOC < prev    next >
Text File  |  1991-03-10  |  5KB  |  132 lines
  1.  
  2.                           -=( UserOn version 2.0 )=-
  3.  
  4.  
  5. What is it:
  6. ===========
  7.  
  8. Useron does almost exacly the same as the useron function of RA 1.0. There's
  9. only one single extra: Whenever a user has the 'external util/door' status
  10. UserOn looks in the RA Directory for a file USERDOES.<NodeNr>. This file
  11. may contain a more accurate description of which door that user entered.
  12. RA only reserves a byte and 6 predefined messages for this purpose, and I
  13. as a doorwrite would like to put the name of the program there.. Alas, this
  14. is not possible with RA, so I wrote this little replacement.
  15.  
  16. Source code (pascal)  for putting, reading and writing such a UserDoes file
  17. is included.
  18.  
  19.  
  20. How To:
  21. =======
  22.  
  23. Simply replace the ShowUsers call with a type 7 call with on the optional
  24. dataline:
  25.  
  26.  <Path>UserOn.exe -T:*T -N:*N [-P:*P] [-SYSOP:ON] [-LINES:<NoLines>]
  27.  
  28. (The -P is only nessecary when you use a commport different from the one in the
  29.  Config.ra, the -N:*N should be there, as this program only makes sence in a
  30.  multiline RA setup)
  31.  
  32. That's all.
  33.  
  34.  
  35. Programmers:
  36. ============
  37.  
  38. The USERDOES.<NodeNr> file is a simple textfile with only one line of text,
  39. Maximal 70 characters long. (should be enough..;)
  40. It's expected to be found in the directory where the RA environment variable
  41. is pointing to. Note that the <NodeNr> part has NO leading zeros!
  42.  
  43.  UserDoes.1   is a legal name
  44.  UserDoes.001 will never be found.
  45.  
  46. If you use the DoIt.Pas unit, things are simpler:
  47.  
  48. Put somewhere in the initialization part of your program the lines:
  49.  
  50. DoingWhat='Your text which has to appear';
  51. SetDoingInfo(NodeNr);
  52.  
  53. And at the end of the program a line:
  54.  
  55. ClearDoingInfo(NodeNr);
  56.  
  57.  
  58. CopyWrong: you are encouraged to include this program with your own programs
  59.            as long as you include the WHOLE package......
  60.  
  61.  
  62.  
  63. Using this program with existing utils and doors:
  64. =================================================
  65.  
  66. Well, from a type 7 menuitem with out a batch you're out
  67. of luck until (and IF) the author of the program supports this
  68. way of showing his info.
  69.  
  70. From a type 15 things are easier, just put a line :
  71.  
  72.   Echo <The text to appear> > c:\RA\userdoes.%1
  73.  
  74. into the batchfile and things should work! The %1 reflects the nodenr here.
  75.  
  76. At the end of the batch you can delete the file with a simple
  77.  
  78.   del c:\ra\userdoes.%1
  79.  
  80.  
  81.  
  82. Last words:
  83. ===========
  84.  
  85. Just in case: you're using this program at your own risk! Never will I accept
  86. any responsibility for anything happening due to the behavior of this program!
  87.  
  88. This program is freeware. Do with it whatever you like. and if you are a
  89. door-programmer yourself, consider supporting the idea.. After all,
  90. when the useron info sais something like:
  91.  
  92.     > User having a good time playing multiline-tradewars
  93.  
  94. The odds are that other users jump in..;-)
  95.  
  96. Enjoy!
  97.  Gerhard
  98.  
  99. ==============================================================================
  100. Version 2.0
  101.  
  102. Added the option to send an online message too.. This isn't my way of
  103. providing a real multiline chatter, but it makes things more decent as
  104. the user get's only one UserOn list. Further I provided an editor to
  105. write longer on-line messages.. (up to 20 lines) which can be edited.
  106. As simple line-editor (but it looks great ansi/avatar too...;-)
  107.  
  108. If you want to give the users the possibility to send online messages
  109. add the parameter -LINES:<NoLines> to the commandline.
  110. If NoLines is 0, NO messages van be send (same as not putting the parameter
  111. on the commandline) if NoLines is greater than 20 the maximal msglength of
  112. 20 lines can be used.. Every number in between puts a maximum on the msglength.
  113. If here's already a NODE??.RA found, the text is appended.
  114.  
  115. ==============================================================================
  116. Version 1.2
  117.  
  118. Found that useron didn't work ok under DV. Found a bug in one of my libraries,
  119. and the problem is solved.
  120.  
  121. Also added a SysOp override, as I don't want to show up in the 'Users today'
  122. list. (Certainly not while testing..) But have no problems with users seeing
  123. me online.. Just add a -SYSOP:ON to the commandline and you're on the list
  124. whatever the 'ExcludeSysopFromList' field is saying..
  125.  
  126. ==============================================================================
  127. Version 1.1
  128.  
  129. Removed the LiveSystems commercial on top of the screen and tried to make it
  130. look as much as possible as the RA UsersOn command..
  131. Also fiddled around with the colors a little..
  132.